home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Utilities / MacDOS™ 2.0.0ƒ / batches / listHelp.out < prev    next >
Encoding:
Text File  |  1994-11-23  |  29.2 KB  |  765 lines  |  [TEXT/ttxt]
  1. Started log file "listHelp.out"  94-08-01  13:01:28
  2.   help ?
  3. !               ALARM           CALL            CD              CHDIR           
  4. CLOSE           CLS             CONFIRM         COPY            DATE            
  5. DECR            DEL             DIR             ECHO            ECHO.           
  6. EJECT           ERASE           EXIT            FOR             GOTO            
  7. HELP            IF              INCR            LOG             MD              
  8. MEM             MKDIR           MORE            NEXT            ONERROR         
  9. OPEN            PATH            PAUSE           PRINT           PROMPT          
  10. RD              READ            REM             REN             RENAME          
  11. RENDIR          REPEAT          RESTART         RMDIR           SERIAL          
  12. SET             SHIFT           SHOW            SHUTDOWN        SSTR            
  13. SUBSTVOL        TIME            TOUPPER         TREE            TYPE            
  14. VER             VERIFY          VOL             WRITE           XCOPY           
  15.  
  16.   help "!"
  17. Identifies comments.
  18.  
  19. ! [comment]
  20.   help "ALARM"
  21. Directs MacDOS to report errors and warnings via a dialog box.
  22.  
  23. ALARM [ON | OFF]
  24.  
  25. Without a parameter, ALARM reports the current setting.
  26.   help "CALL"
  27. While in batch, executes a program and returns to the next line of
  28. the original program.
  29.  
  30. CALL file [param]
  31.  
  32.   file    is a filename, possibly preceded by a volume and path spec.
  33.           If file is of type 'TEXT', MacDOS executes is as a batch program.
  34.           If file identifies an application or an AppleScript, MacDOS
  35.           launches it. If file identifies a document, MacDOS launches the
  36.           corresponding application and passes to it the document.
  37.   param   are passed to the program being called if it is a batch. If file
  38.           identifies an application, MacDOS passes the first parameter to it
  39.           as a document name.
  40.   help "CD"
  41. Changes the current directory or displays its name.
  42.  
  43. CD [dir]
  44.  
  45.   dir     is the name of the new directory and can include volume
  46.           and path.
  47.  
  48.           When two dots are used as directory name, CD changes
  49.           to the parent directory.
  50.  
  51.           When a volume ID followed by a colon is used as directory
  52.           name, CD displays the current directory in the given
  53.           volume.
  54.  
  55.           Without directory name, CD displays the current volume
  56.           and directory.
  57.   help "CHDIR"
  58. Changes the current directory or displays its name.
  59.  
  60. CHDIR [dir]
  61.  
  62.   dir     is the name of the new directory and can include volume
  63.           and path.
  64.  
  65.           When two dots are used as directory name, CHDIR changes
  66.           to the parent directory.
  67.  
  68.           When a volume ID followed by a colon is used as directory
  69.           name, CHDIR displays the current directory in the given
  70.           volume.
  71.  
  72.           Without directory name, CHDIR displays the current volume
  73.           and directory.
  74.   help "CLOSE"
  75. Closes a file opened with the command OPEN.
  76.  
  77. CLOSE fileID
  78.  
  79.  fileID  is the number returned by OPEN.
  80.          No error or warning is returned when the file is found already closed.
  81.   help "CLS"
  82. Clears the console window.
  83.  
  84. CLS
  85.   help "CONFIRM"
  86. Directs MacDOS to ask for confirmation before overwriting existing
  87. files.
  88.  
  89. CONFIRM [ON | OFF]
  90.  
  91. Without a parameter, CONFIRM reports the current setting.
  92.   help "COPY"
  93. Copies one or more files.
  94.  
  95. COPY source [,...] [destination] [/A] [/C=creator] [/D] [/P] [/R]
  96.      [/T=file-type] [/U] [/V]
  97.  
  98.   source       specifies what is to be copied.
  99.                It can be a filename, a wildcarded filename, a directory
  100.                name, or several items separated by commata. Each item can
  101.                include a volume and path spec.
  102.   destination  specifies where the source should be copied to.
  103.                It can be a file or directory name, possibly preceded by
  104.                a volume and path spec.
  105.   /A           appends the source to the destination.
  106.   /C=creator   only copies files of the given creator.
  107.   /D           only copies data forks.
  108.   /P           prompts the user for confirmation before overwriting
  109.                existing files.
  110.   /R           only copies resource forks.
  111.   /T=file-type only copies files of the given file type.
  112.   /U           only overwrites existing destination files if the
  113.                corresponding source was updated more recently.
  114.   /V           verifies that the destination has been written correctly.
  115.   help "DATE"
  116. Displays and sets the current date or the date format.
  117.  
  118. DATE [format | date]
  119.  
  120.   format   is a string which specifies order and number of digits
  121.            of year, month, and day. It also specifies the separators
  122.            to be used (eg. YYY-MM-DD).
  123.  
  124.   date     is the date which the user wants to become the current date.
  125.            It is specified in the current format.
  126.  
  127. Without parameter, DATE displays the current date and asks for the new
  128. date/format. The user must reply with a RETURN in order to leave both
  129. date and format unchanged.
  130.   help "DECR"
  131. Decrements or shortens values of variables.
  132.  
  133. DECR [+ | -]var [BY {number | string}]
  134.  
  135.   [+|-]var  is the name of a variable possibly preceded by a plus
  136.             or minus sign. DECR uses the sign to decide whether to
  137.             operate at the end or at the beginning of the string
  138.             contained in var.
  139.   number    is a signed integer number which DECR subtracts from
  140.             var when var is numeric. When var is not numeric and
  141.             number is positive, DECR removes characters from var
  142.             (when number is negative, DECR adds spaces instead).
  143.   string    is a non-numeric string. DECR removes it from var
  144.             regardless of whether var is numeric or not.
  145.  
  146. Defaults: "DECR var" is equivalent to "DECR +var BY 1"
  147.   help "DEL"
  148. Deletes one or more files.
  149.  
  150. DEL file [C=creator] [/P] [/T=file-type]
  151.  
  152.   file         specifies what files are to be deleted.
  153.                It can be a filename, a wildcarded filename, or a directory
  154.                name, possibly preceded by a volume and path spec.
  155.                With a directory name, DEL deletes all the files in the
  156.                directory.
  157.  
  158.   /C=creator   only deletes files of the given creator.
  159.  
  160.   /P           prompts the user for confirmation before deleting each file.
  161.  
  162.   /T=file-type only deletes files of the given file type.
  163.   help "DIR"
  164. Lists the items contained in a directory.
  165.  
  166. DIR file [/A[[:]attributes]] [/B] [/C=creator] [/L] [/O[[:]order]]
  167.          [/P] [/S] [/T=file-type] [/W]
  168.  
  169.   file         identifies the file to be listed. It can also be a wildcarded
  170.                filename or a directory name, possibly preceded by a volume
  171.                and path spec.
  172.   /A           lists items with specified attributes (a minus sign as a
  173.                prefix means 'not'):
  174.                   D  Directories
  175.                   F  Files
  176.                   H  Hidden files
  177.                   X  Aliases
  178.   /B           list item names one per line and without headings (bare format).
  179.   /C=creator   only lists files of the given creator.
  180.   /L           uses lowercase when filtering entries on the basis of wildcards.
  181.   /O           sorts the list with the following ordering options (a minus
  182.                sign as a prefix reverses the order):
  183.                   D  by Date & time of update (older first)
  184.                   G  Group directories first
  185.                   N  by Name (alphabetic)
  186.                   S  by Size (smallest first)
  187.   /P           pauses after each screenful of listing.
  188.   /S           recursive display of all subdirectories of a given directory.
  189.   /T=file-type only lists files of the given file type.
  190.   /W           list item names in a wide format.
  191.  
  192. Switches may be preset in the DIRCMD environment variable. When preset,
  193. a switch can be overriden by prefixing it in DIR with a minus sign.
  194.   help "ECHO"
  195. Displays messages or turns batch command-echoing ON and OFF.
  196.  
  197. ECHO [ [message] | [ON | OFF] ]
  198. ECHO.
  199.  
  200. Without a parameter, ECHO reports the current setting.
  201. Immediately followed by a dot, ECHO displays a new-line.
  202.   help "ECHO."
  203. Displays a new-line.
  204.  
  205. ECHO.
  206.   help "EJECT"
  207. Removes a volume and ejects a floppy.
  208.  
  209. EJECT volume [/E]
  210.  
  211.   volume  is the volume ID which identifies a removable volume to
  212.           be ejected.
  213.  
  214.   /E      only ejects the volume without removing it from the
  215.           volume list.
  216.   help "ERASE"
  217. Deletes one or more files.
  218.  
  219. DEL file [C=creator] [/P] [/T=file-type]
  220.  
  221.   file         specifies what files are to be deleted.
  222.                It can be a filename, a wildcarded filename, or a directory
  223.                name, possibly preceded by a volume and path spec.
  224.                With a directory name, DEL deletes all the files in the
  225.                directory.
  226.  
  227.   /C=creator   only deletes files of the given creator.
  228.  
  229.   /P           prompts the user for confirmation before deleting each file.
  230.  
  231.   /T=file-type only deletes files of the given file type.
  232.   help "EXIT"
  233. Quits MacDOS and other applications.
  234.  
  235. EXIT [appFile]
  236.  
  237.   appFile  is the filename of the application which should quit,
  238.            possibly preceded by a volume and path spec. When appFile
  239.            is missing MacDOS terminates itself.
  240.   help "FOR"
  241. Executes a command for each file in a set.
  242.  
  243. FOR %var [/L] IN (set) DO [command [parameters] | BEGIN]
  244.  
  245.   %var       specifies a parameter name.
  246.   /L         does not convert to upper case the filenames. This switch
  247.              can be in any position before the "DO".
  248.   set        consists of one or more items. Each item is a filename (possibly
  249.              wildcarded) or a directory name. File and directory names
  250.              can be preceded by a volume and path spec.
  251.   command    is the command to be carried out for each file and can be
  252.              the name of a batch file (possibly with volume and path spec).
  253.   parameters are passed to the command or batch program being executed for
  254.              each file.
  255.  
  256. FOR %var IN (set) DO BEGIN
  257.   is only allowed within a batch program. The lines following the FOR up
  258.   to the corresponding "NEXT var" are executed for each file in the set.
  259.   In this case, a global variable is created and the commands within the
  260.   loop must refer to %var% (rather than %var) to obtain the current file
  261.   name. It is up to the user to remove the variable after completing the
  262.   batch program or within the program after exiting the FOR loop.
  263.   help "GOTO"
  264. Continues execution from a labelled line while in batch.
  265.  
  266. GOTO label
  267.  
  268.   label   is a string used as a label in the current batch program.
  269.           When used as a parameter of a GOTO, the label must not
  270.           contain the initial colon.
  271.   help "HELP"
  272. Provides help information for all MacDOS commands.
  273.  
  274. HELP [entry | ?]
  275.  
  276.   entry   is a command name.
  277.              When the parameter is missing, HELP displays a brief summary of all
  278.              entries. When a question mark is entered as a parameter, HELP displays
  279.              the list of entries available without any detailed information.
  280.   help "IF"
  281. Performs conditional processing in batch.
  282.  
  283. IF [NOT] {string1==string2 | EXIST filename | EXISTDIR name} {command | prog}
  284.  
  285.   NOT               negates the condition.
  286.   string1, string2  can contain replaceable parameters and global variables.
  287.   EXIST filename    is true if the specified file exists. 'filename' can be
  288.                     wildcarded and preceded by a volume and path spec. If
  289.                     'filename' identifies a directory the condition is not
  290.                     satisfied.
  291.   EXISTDIR name     is true if the specified directory exists. 'name' can be
  292.                     preceded by a volume and path spec. If 'name' identifies a
  293.                     file the condition is not satisfied.
  294.   command           is the command to be executed if the condition is satisfied.
  295.   prog              identifies the program to be executed if the condition is
  296.                     satisfied.
  297.   help "INCR"
  298. Increments or extends values of variables.
  299.  
  300. INCR [+ | -]var [BY {number | string}]
  301.  
  302.   [+|-]var  is the name of a variable possibly preceded by a plus
  303.             or minus sign. INCR uses the sign to decide whether to
  304.             operate at the end or at the beginning of the string
  305.             contained in var.
  306.   number    is a signed integer number which INCR adds to var when
  307.             var is numeric. When var is not numeric and number is
  308.             positive, INCR appends/prepends spaces to var (when
  309.             number is negative, INCR removes characters instead).
  310.   string    is a non-numeric string. INCR appends/prepends it to var
  311.             regardless of whether var is numeric or not.
  312.  
  313. Defaults: "INCR var" is equivalent to "INCR +var BY 1"
  314.   help "LOG"
  315. Captures MacDOS commands and text displayed on the monitor.
  316.  
  317. LOG [file] [/A] [/O]
  318. LOG [/-]
  319.  
  320.   file   identifies the file to be used for storing the logged text.
  321.          It can include a volume and path spec. Without the 'file'
  322.          parameter, LOG closes the current log file and stops logging.
  323.  
  324.   /A     appends logged text to the given file instead of overwriting it.
  325.  
  326.   /O     directs MacDOS to log everything which is displayed, rather
  327.          than only the commands as typed by the user.
  328.  
  329.   /-     closes the log file but without sending the closing message
  330.          to it. This is useful when the log file is to be used as a
  331.          batch program.
  332.   help "MD"
  333. Creates a directory.
  334.  
  335. MD directory
  336.   help "MEM"
  337. Provides information on the list of executing processes.
  338.  
  339. MEM
  340.   help "MKDIR"
  341. Creates a directory.
  342.  
  343. MKDIR directory
  344.   help "MORE"
  345. Displays output information one screen at a time.
  346.  
  347. MORE < file
  348.  
  349.   file            is the file to be listed one screen at a time.
  350.  
  351. MORE can be used to display the output of other MacDOS commands as follows:
  352.   command | MORE
  353.  
  354. When the output is redirected to a file and the input is not redirected, MORE
  355. can be used to generate small text files (EOF is CNTL-Z).
  356.   help "NEXT"
  357. Terminates a multi-line FOR-loop.
  358.  
  359. NEXT varname
  360.  
  361.   varname   is the control variable of the FOR-loop and should be typed
  362.             without the percent signs used to obtain the variable value.
  363.  
  364. Note that FORs cannot be nested.
  365.   help "ONERROR"
  366. Specifies a label for error handling in batch.
  367.  
  368. ONERROR [label]
  369.  
  370.   label   is the label at which execution should continue whenever an
  371.           error occurs within a batch program. Without this parameter,
  372.           ONERROR resets the error handling and no jump takes place
  373.           when an error occurs.
  374.   help "OPEN"
  375. Opens a text file.
  376.  
  377. OPEN [file [varID]] [{/R | /W | /A}]
  378.  
  379.  file   is a filename possibly preceded by a volume and path spec.
  380.         The file can be closed with the command CLOSE.
  381.         With no parameters, OPEN displays the list of opened files.
  382.  varID  is the name of the variable where the fileID is to be stored.
  383.         If it is missing, the fileID is displayed on the screen.
  384.  /R     opens an existing text file to read (see the command READ).
  385.         If the file does not exist, OPEN fails. /R is the default
  386.         when no switch is provided.
  387.  /W     opens a new text file to write (see the command WRITE). If
  388.         the file already exists, OPEN deletes it before opening the
  389.         new one.
  390.  /A     opens an existing file to write past the current EOF (see the
  391.         command WRITE). If the file does not exist, OPEN creates it.
  392.  
  393. Only one of /R, /W, and /A at a time is allowed in a command.
  394.   help "PATH"
  395. Displays and sets a search path for executable files.
  396.  
  397. PATH [paths]
  398.  
  399.   paths   is a list of paths separated by semicolons. If the
  400.           parameter 'paths' is missing, PATH displays the current
  401.           list. If 'paths' consists of a single semicolon, PATH
  402.           resets the list.
  403.  
  404. Example: path c:\;\bin;1:\batches
  405.  
  406. "PATH paths" is equivalent to "SET PATH=paths"
  407.   help "PAUSE"
  408. Suspends execution of a batch program and asks the user whether execution
  409. should be resumed.
  410.  
  411. PAUSE
  412.   help "PRINT"
  413. Prints text files.
  414.  
  415. PRINT [file] [/P] [/D]
  416.  
  417.   file  specifies what is to be printed.
  418.         It can be a filename, a wildcarded filename, or a directory
  419.         name, possibly preceded by a volume and path spec.
  420.         PRINT ignores files which are not of type 'TEXT'.
  421.         If 'file' is missing, PRINT prints the console window.
  422.  
  423.   /P    prompts the user for confirmation before printing
  424.         each file.
  425.  
  426.   /D    displays the standard Print dialog before printing the
  427.         first file of a series.
  428.   help "PROMPT"
  429. Changes the command prompt.
  430.  
  431. PROMPT [text]
  432.  
  433.   text    is the new command prompt. When the parameter 'text' is missing,
  434.           PROMPT resets to the default ($N$G).
  435.  
  436. PROMPT sees a dollar sign as an indication that the following character
  437. is to be interpreted as a special code. The following codes are supported:
  438.  
  439.   $Q   = (equal sign)
  440.   $$   $ (dollar sign)
  441.   $T   system time
  442.   $D   current date
  443.   $P   current volume and path
  444.   $V   MacDOS version number
  445.   $N   current volume
  446.   $G   > (greater-than sign)
  447.   $L   < (less-than sign)
  448.   $B   | (pipe)
  449.   $H   backspace (erases the previous character)
  450.   $E   escape (ASCII code 27)
  451.   $_   new-line
  452.   help "RD"
  453. Deletes (removes) a directory.
  454.  
  455. RD directory
  456.   help "READ"
  457. Reads a line of text from a file opened with OPEN.
  458.  
  459. READ fileID [var]
  460.  
  461.  fileID  is the number returned by OPEN.
  462.          The file can be closed with the command CLOSE and is automatically
  463.          closed when the EOF is read.
  464.  var     is the name of the global variable where the line is to be stored.
  465.          If it is missing, the line is displayed on the screen.
  466.          READ strips the newline character (CR) at the end of each line
  467.          containing more than one character, and replaces it with a space
  468.          if the line only contains the CR. This guarantees that a non-empty
  469.          line is always returned.
  470.   help "REM"
  471. Identifies comments (remarks).
  472.  
  473. REM [comment]
  474.   help "REN"
  475. Changes name, creator, and/or file-type of one or more files. It also
  476. assigns the current date/time and toggles the ‘hidden’ file attribute.
  477.  
  478. REN source [destination] [/!] [/C=src-creator] [/C!dst-creator] [/D]
  479.     [/H] [/L] [/T=src-file-type] [/T!dst-file-type]
  480.  
  481.   source           specifies what is to be renamed.
  482.                    It can be a filename, a wildcarded filename, or a
  483.                    directory name, possibly preceded by a volume and path spec.
  484.   destination      specifies the new name[s].
  485.                    It can only be a file name, possibly wildcarded but NOT
  486.                    preceded by a volume and path spec.
  487.   /!               automatically modifies the destination filenames if there
  488.                    are duplicates, so that the command can be completed.
  489.   /C=src-creator   only renames files of the given src-creator.
  490.   /C!dst-creator   changes the creator to the given dst-creator.
  491.   /D               assigns the current date/time to the source.
  492.   /H               makes visible the hidden sources and hides the visible
  493.                    sources.
  494.   /L               makes the selection of sources case sensitive.
  495.   /T=src-file-type only renames files of the given src-file-type.
  496.   /T!dst-file-type changes the file type to the given dst-file-type.
  497.   help "RENAME"
  498. Changes name, creator, and/or file-type of one or more files. It also
  499. assigns the current date/time and toggles the ‘hidden’ file attribute.
  500.  
  501. REN source [destination] [/!] [/C=src-creator] [/C!dst-creator] [/D]
  502.     [/H] [/L] [/T=src-file-type] [/T!dst-file-type]
  503.  
  504.   source           specifies what is to be renamed.
  505.                    It can be a filename, a wildcarded filename, or a
  506.                    directory name, possibly preceded by a volume and path spec.
  507.   destination      specifies the new name[s].
  508.                    It can only be a file name, possibly wildcarded but NOT
  509.                    preceded by a volume and path spec.
  510.   /!               automatically modifies the destination filenames if there
  511.                    are duplicates, so that the command can be completed.
  512.   /C=src-creator   only renames files of the given src-creator.
  513.   /C!dst-creator   changes the creator to the given dst-creator.
  514.   /D               assigns the current date/time to the source.
  515.   /H               makes visible the hidden sources and hides the visible
  516.                    sources.
  517.   /L               makes the selection of sources case sensitive.
  518.   /T=src-file-type only renames files of the given src-file-type.
  519.   /T!dst-file-type changes the file type to the given dst-file-type.
  520.   help "RENDIR"
  521. Changes the name of a single directory.
  522.  
  523. REN source destination
  524.  
  525.   source           specifies the directory to be renamed.
  526.                    It can be preceded by a volume and path spec.
  527.   destination      specifies the new name of the directory.
  528.                    It cannot be preceded by a volume and path spec.
  529.   help "REPEAT"
  530. Repeats a block of lines in a batch program.
  531.  
  532. REPEAT label
  533.  
  534.   label  identifies the last line to be executed before returning to
  535.          the first line of the block. As a label cannot be followed by
  536.          a command in the same line, the block to be repeated consists
  537.          of all the lines between the REPEAT and the corresponding label.
  538.          Repeats cannot be nested.
  539.  
  540.   You can replace a "REPEAT label"/":label" with a ":label"/"GOTO label".
  541.   help "RESTART"
  542. Restarts the Macintosh.
  543.  
  544. RESTART
  545.   help "RMDIR"
  546. Deletes (removes) a directory.
  547.  
  548. RMDIR directory
  549.   help "SERIAL"
  550. Directs MacDOS to use the modem serial port for Input/Output.
  551.  
  552. SERIAL [inout | OFF] [/M]
  553.  
  554.   inout  specifies the ports to be used for serial communication.
  555.          It consists of a pair of letters (not case sensitive) which
  556.          specify the port to be used for input and output respectively.
  557.          For example:
  558.          AA  sets both input and output to port A (the modem port).
  559.              MacDOS then sends to port A all characters displayed in
  560.              the console window, and accepts characters from port A as
  561.              if they had been typed on the keyboard.
  562.          BA  sets the input to port B (the printer port) and the output
  563.              to port A (the modem port). MacDOS then sends to port A
  564.              all characters displayed in the console window, and accepts
  565.              characters from port B as if they had been typed on the
  566.              keyboard.
  567.          Note that the console window and the keyboard remain operational
  568.          while I/O via the serial port[s] is enabled.
  569.   OFF    disables I/O via the serial port[s].
  570.   /M     specifies that MacDOS has just to Monitor the characters read
  571.          from the serial port instead of interpreting them as commands.
  572.          By default, MacDOS accepts commands from the serial port.
  573. Without a parameter, SERIAL reports the current setting.
  574.  
  575. The port is set to 9600 bps, no parity, 8 data bits, 1 stop bit, and
  576. hardware handshaking.
  577.   help "SET"
  578. Displays, sets, and removes global variables.
  579.  
  580. SET [var=[value]]
  581.  
  582.   var     is the name of the variable.
  583.   value   is the string to be assigned to the variable. When the parameter
  584.           'value' is missing, SET removes user-defined variables and
  585.           resets to their default system variables.
  586.  
  587. Without parameters, SET displays the list of variables with their values.
  588.   help "SHIFT"
  589. Moves the replaceable parameters of a batch program forward one position.
  590.  
  591. SHIFT
  592.   help "SHOW"
  593. Retrieves the message corresponding to an error code.
  594.  
  595. SHOW err [var]
  596.  
  597.   err   is the error code for which the message should be displayed
  598.   var   is the variable where SHOW stores the message. If 'var' is
  599.         missing, SHOW displays the message on the screen.
  600.  
  601. If no message can be found, SHOW returns the parameter err itself.
  602. As additional parameters are ignored, SHOW can also be used to
  603. select the first word of a sentence.
  604.   help "SHUTDOWN"
  605. Shits down the Macintosh.
  606.  
  607. SHUTDOWN
  608.   help "SSTR"
  609. Extracts substrings from variables.
  610.  
  611. SSTR var [delim] [/E] [/L | /R]
  612.  
  613.   var     is the name of the variable from which the substring is
  614.           to be extracted. SSTR replaces the content of 'var' with
  615.           the substring.
  616.   delim   is the string which delimits the substring. MacDOS searches
  617.           'var' and stops when it finds 'delim'. Depending on the
  618.           presence of switches, MacDOS extract from 'var' the
  619.           substring on the left or on the right of 'delim'. If 'delim'
  620.           is empty or missing or if 'delim' is not found within 'var',
  621.           'var' is left unchanged. An error condition occurs when 'var'
  622.           does not contain 'delim'.
  623.           Note that 'delim' must precede any switch if it begins with '/'.
  624.   /E      searches 'var' from the End (i.e. from right to left).
  625.           Without /E, SSTR searches 'var' from left to right.
  626.   /L      extracts the substring on the Left of 'delim' (this is the
  627.           default).
  628.   /R      extracts the substring on the Right of 'delim'.
  629.  
  630. /L and /R cannot be present simultaneously. Note that the searches
  631. are always case sensitive. Use TOUPPER to convert strings to upper
  632. case, so that searches can be made case insensitive.
  633.  
  634. Examples:
  635.   ! initially VAR contains: "a few chars and nothing more"
  636.   SSTR VAR "and nothing"
  637.   ! VAR now contains: "a few chars "
  638.   SSTR VAR /E " "
  639.   ! VAR now contains: "a few chars"
  640.   SSTR VAR w /R
  641.   ! VAR now contains: " chars"
  642.   help "SUBSTVOL"
  643. Associates a letter to a volume ID.
  644.  
  645. SUBSTVOL letter volume
  646.  
  647.   letter   is a character between 'A' and 'Z' (case is irrelevant).
  648.  
  649.   volume   is a volume identifier (1 is the first volume mounted and
  650.            corresponds to the startup volume).
  651.   help "TIME"
  652. Displays and sets the system time or the time format.
  653.  
  654. TIME [time]
  655.  
  656.   time   is the time which should become the new system time. Also,
  657.          the format of the new time becomes the new format used by
  658.          MacDOS whenever it displays a time. If you type midnight (i.e.
  659.          00:00:00a in 12h format and 24:00:00 in 24h format), MacDOS
  660.          only updates the time format and leaves the system time unchanged.
  661.          If you omit time, MacDOS displays the current system time in the
  662.          current format and prompts you for a new time. You can then type
  663.          the new time, or hit Carriage Return if you do not want to change
  664.          anything.
  665.   help "TOUPPER"
  666. Converts variables to uppercase.
  667.  
  668. TOUPPER var
  669.  
  670.   var  is the name of the variable to be converted. TOUPPER
  671.        replaces the content of 'var' with its uppercase version.
  672.   help "TREE"
  673. Displays a directory structure graphically.
  674.  
  675. TREE path [/A[[:]attributes]] [/B] [/C=creator] [/L] [/O[[:]order]]
  676.          [/P] [/S] [/T=file-type] [/W]
  677.  
  678. TREE accepts all the switches defined for DIR, but some of them have no
  679. effect.
  680.  
  681.   path         is the root of the tree. It defaults to the current directory.
  682.   /F           displays the filenames in each directory.
  683.   /A           lists items with specified attributes (a minus sign as a
  684.                prefix means 'not'):
  685.                   D  Directories
  686.                   F  Files
  687.                   H  Hidden files
  688.                   X  Aliases
  689.                Note that /A:-F overrides /F. Therefore, "TREE /A-F/F" will NOT
  690.                display files.
  691.   /B           no effect.
  692.   /C=creator   only lists files of the given creator.
  693.   /L           uses lowercase when filtering entries on the basis of wildcards.
  694.   /O           sorts the list with the following ordering options (a minus
  695.                sign as a prefix reverses the order):
  696.                   D  by Date & time of update (older first)
  697.                   G  Group directories first
  698.                   N  by Name (alphabetic)
  699.                   S  by Size (smallest first)
  700.   /P           pauses after each screenful of listing.
  701.   /S           recursive display of all subdirectories of a given directory.
  702.   /T=file-type only lists files of the given file type.
  703.   /W           no effect.
  704.  
  705. Switches may be preset in the DIRCMD environment variable. When preset,
  706. a switch can be overriden by prefixing it in TREE with a minus sign.
  707.   help "TYPE"
  708. Displays the content of a text file on the monitor.
  709.  
  710. TYPE file [/H | /R]
  711.  
  712.   /H  dumps in HEX the data fork of 'file'
  713.  
  714.   /R  dumps in HEX the resource fork of 'file'
  715.   help "VER"
  716. Displays the version of MacDOS.
  717.  
  718. VER
  719.   help "VERIFY"
  720. Directs MacDOS to verify that files are written correctly when copied.
  721.  
  722. VERIFY [ON | OFF]
  723.  
  724. Without a parameter, VERIFY reports the current setting.
  725.   help "VOL"
  726. Displays the volume name.
  727.  
  728. VOL [volume]
  729.  
  730.   volume   is the volume letter or volume ID. It defaults to the current volume.
  731.   help "WRITE"
  732. Writes a line of text to a file opened with OPEN.
  733.  
  734. WRITE fileID what
  735.  
  736.  fileID  is the number returned by OPEN.
  737.          The file can be closed with the command CLOSE.
  738.  what    is the line of text to be written into the file. Note that
  739.          the text must be quoted if it contains spaces. WRITE
  740.          appends a newline character (CR) to each line before
  741.          writing it into the file.
  742.   help "XCOPY"
  743. Copies directories and directory trees.
  744.  
  745. XCOPY source [destination] [/C=creator] [/D:date] [/E] [/P] [/S] [/T=file-type] [/V]
  746.  
  747.   source       identifies the directory to be copied.
  748.   destination  identifies the location of the new files. It defaults to the
  749.                current directory.
  750.   /C=creator   only copies files of the given creator.
  751.   /D:date      copies files changed on or after the specified date.
  752.   /E           copies all [sub]directories, even if empty.
  753.   /P           prompts the user before creating each destination file.
  754.   /S           copies directories and subdirectories except empty ones.
  755.   /T=file-type only copies files of the given type.
  756.   /V           verifies each file copied.
  757.  
  758. Hidden files are not copied.
  759. Aliases are not resolved. Therefore, aliased folders appear in the
  760. copied directory as they appeared in the original one.
  761. Files and subdirectories cannot be copied onto themselves. Therefore,
  762. 'source' and 'destination' must identify different directories.
  763.   log
  764. Stopping log file "listHelp.out"  94-08-01  13:02:01
  765.